home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / system / pc_dcl.zip / HELP / APPEND.HTX < prev    next >
Text File  |  1991-10-15  |  4KB  |  164 lines
  1. APPEND
  2.  
  3.  APPEND
  4.  
  5.     Adds the contents of one or more specified input files to the end of
  6.     the specified output file.
  7.  
  8.     Format:
  9.  
  10.  
  11.       APPEND  input-file-spec output-file-spec
  12.  
  13.  
  14.     Additional information :
  15.  
  16.        Input-file-spec append.input-file-spec     output-file-spec append.output-file-spec
  17.        /ALL append./all     /BEFORE append./all    /BINARY append./bin    /CONFIRM append./confirm    /LOG append./log    
  18.        /SINCE append./since   /SUBDIRECTORY append./subdir         /TEXT append./bin
  19.        Examples append./subdir
  20.  
  21.  
  22. append.input-file-spec
  23.  
  24.  APPEND
  25.  
  26.      input-file-spec
  27.  
  28.       Specifies the names of one or more input files to be appended.
  29.  
  30.  
  31. append.output-file-spec
  32.  
  33.  APPEND
  34.  
  35.      output-file-spec
  36.  
  37.       Specifies the name of the file to which  the  input  files  will  be
  38.       appended.
  39.  
  40.       You  must  include  at  least  one  field   in   the   output   file
  41.       specification.  If you do not specify a device and/or directory, the
  42.       APPEND command uses the current default device and  directory.   For
  43.       other  fields  that  you do not specify, the APPEND command uses the
  44.       corresponding field of the input file specification.
  45.  
  46.       If you use the asterisk wildcard character  in  any  fields  of  the
  47.       output file specification, the APPEND command uses the corresponding
  48.       field of the input file specification.  If you  are  appending  more
  49.       than  one  input file, APPEND uses the corresponding fields from the
  50.       first input file.
  51.  
  52. append./all
  53.  
  54.  APPEND
  55.  
  56.      /ALL
  57.  
  58.     selects all the files, including those with the HIDDEN or SYSTEM 
  59.     attribute flag on.
  60.  
  61.  
  62.  APPEND
  63.  
  64.      /BEFORE=time
  65.  
  66.       Selects only those files that are dated before  the  specified time.
  67.       You can specify either an absolute time or a combination of absolute
  68.       and delta times.  See the  VMS  DCL  Concepts  Manual  for  complete
  69.       information on specifying time values. You can also use the keywords
  70.       NOW, TODAY, TOMORROW, and  YESTERDAY.
  71.  
  72. append./bin
  73.  
  74.  APPEND
  75.  
  76.      /BINARY
  77.  
  78.       Reads the input file(s) in binary mode (I.E. reads all the data 
  79.       up to physical end of file, including any CTRL-Z characters.
  80.  
  81.  
  82.  APPEND
  83.  
  84.      /TEXT
  85.  
  86.       Reads the input file(s) in text mode (I.E. reads the data up to 
  87.       a CTRL-Z character or the physical end of file,  whatever comes 
  88.       first.
  89.  
  90.  
  91. append./confirm
  92.  
  93.  APPEND
  94.  
  95.     /CONFIRM
  96.  
  97.       Controls whether a request is issued before each  individual  APPEND
  98.       operation  to confirm that the operation should be performed on that
  99.       file.
  100.       When the system  issues  the  prompt,  you  can  issue  any  of  the
  101.       following responses:
  102.  
  103.            YES    NO       QUIT
  104.            TRUE   FALSE
  105.            1      0        ALL
  106.            <RET>
  107.  
  108.       You can use any combination of upper- and lowercase letters for word
  109.       responses.  Word responses can be abbreviated to one or more letters
  110.       (for example, T, TR, or TRU for TRUE).  Affirmative answers are YES,
  111.       TRUE, and 1.  Negative answers are NO, FALSE, 0, and <RET>.
  112.       QUIT  indicates that you want to stop  processing  the  command  at
  113.       that  point.   When  you  respond with ALL, the command continues to
  114.       process, but no further prompts are given.  If you type  a  response
  115.       other than one of those in the list, the prompt will be reissued.
  116.  
  117. append./log
  118.  
  119.  APPEND
  120.  
  121.  
  122.     /LOG
  123.  
  124.       Controls whether the APPEND command displays the file specifications
  125.       of each file appended.
  126.  
  127.  
  128. append./since
  129.  
  130.  APPEND
  131.  
  132.      /SINCE=time
  133.  
  134.      Selects only those files that are dated after the specified time.
  135.  
  136.       You can specify either an absolute time or a combination of absolute
  137.       and delta times.   See  the  VMS  DCL  Concepts  Manual for complete
  138.       information on  specifying  time  values.   You  can  also  use  the
  139.       keywords TODAY,  TOMORROW,  and YESTERDAY.
  140.  
  141.  
  142. append./subdir
  143.  
  144.  APPEND
  145.  
  146.      /SUBDIR
  147.  
  148.      Use this flag for scanning subdirectories when using MS-DOS file
  149.      specifications. 
  150.  
  151.  
  152.  
  153.  APPEND
  154.  
  155.   Examples
  156.  
  157.  
  158.       1.   $ APPEND  TEST3.DAT TESTALL.DAT
  159.  
  160.       The APPEND command appends the contents of the file  TEST3.DAT  from
  161.       the default disk and directory to the file TESTALL.DAT, also located
  162.       on the default disk and directory.
  163. 
  164.